home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / utility / 373 / utility2 / unzip.doc < prev    next >
Encoding:
Text File  |  1989-04-20  |  4.6 KB  |  125 lines
  1.                                    ST_UnZip
  2.   
  3.                            Version 1.2, 03-30-89
  4.   
  5.                            Zipfile Extract Utility
  6.   
  7.           Copyright (C) 1989 Samuel H. Smith;  ALL RIGHTS RESERVED
  8.             
  9.             Atari ST Adaptation (inline crc routine, and executable)
  10.             (C) 1989 Darin Wayrynen
  11.   
  12. 'UnZip' is a small Zipfile extract utility.   It is written to be as
  13. small and portable as possible -- ideal as a starting point for handling
  14. .ZIP files in non-IBM/Atari ST environments.
  15.  
  16. Source code is provided in C.  If you port this program to a 
  17. non-IBM/Atari ST system, we would appreciate a copy of the ported 
  18. source and exec files.
  19.  
  20.  
  21. Usage
  22. -----
  23. desktop:
  24.    drive:\path\filename[.zip]
  25.    
  26. shell:
  27.    unzip drive:\path\filename[.zip]
  28.    
  29. Atari ST note: Unzip will place unzipped files into the current directory
  30.  (usually into the folder you ran unzip from).  To run from the desktop,
  31.  rename unzip.prg to unzip.ttp and enter zip file name into the Tos Takes
  32.  Parameters box after clicking on unzip.ttp.  It would be best to create a
  33.  new directory on your hard drive, or a blank floppy disk, and then copy
  34.  unzip.ttp to it before running the program, otherwise the unziped files 
  35.  will be mixed in with all the files in the current directory.
  36.  When running it from a shell, you can change your current directory to a
  37.  blank directory, and then specify the full pathname for unzip and the zip
  38.  file on the command line (or just 'unzip drive:\path\filename[.zip] if
  39.  your shell support directory hashing like Gulam does).
  40.  
  41.  If any interest is shown in the program, a gem based shell will be written
  42.  to support unzip. 
  43.  
  44.  
  45. Revision history
  46. ----------------
  47.  
  48. 3-3-89 (Samuel)
  49.    Initial alpha test release.
  50.  
  51. 3-5-89 (Samuel)
  52.    First fully operational release.  Does not implement CRC verification,
  53.    but should correctly unzip all compression methods.
  54.  
  55. 3-6-89 (Samuel)
  56.    Corrected end-of-file detection in both shrink and reduce expanders.
  57.    Resulting files should now always have the correct size.  Added ".ZIP"
  58.    default to unzip.c to match calling conventions of unz.pas.
  59.  
  60. 3-8-89 (Samuel)
  61.    Moved machine and operating-system specific code to a block starting
  62.    around line 180.  Added code to swap bytes on host machines that
  63.    store the high order bytes in lower address locations than the low
  64.    order bytes.
  65.  
  66. 3-15-89 (Samuel)
  67.    Added CRC checking in UNZIP.C.  Speeded operation by about 150%.
  68.  
  69.    I'm spending my time on the C version now and don't plan to do any
  70.    further work on the pascal.  If you're using the pascal version
  71.    please contact me.
  72.  
  73. 3-30-89 (Darin)
  74.    Custom 68000 assembly routine written for 32 bit CRC calculation,
  75.    enlarged buffer support, and slight changes made to improve 
  76.    execution speed on the Atari ST.  I'll be spending my time re-writing
  77.    most of the time consuming routines into assembly, and making equivelent
  78.    changes to the ST source as Samuel updates the IBM source.
  79.    
  80. LICENSE
  81. =======
  82.  
  83. You may copy and distribute this program freely, provided that:
  84.     1)   No fee is charged for such copying and distribution, and
  85.     2)   It is distributed ONLY in its original, unmodified state.
  86.  
  87. If you wish to distribute a modified version of this program, you MUST
  88. include the source code.
  89.  
  90. 68000 assembly code for CRC calculations cannot be used in any program
  91. where source is not included.  Contact either Samuel or Darin on the
  92. Tool Shop bbs if interested in commercial applications using the 
  93. assembly code.
  94.  
  95. If you modify this program, we would appreciate a copy of the new source
  96. code.  Samuel is holding the copyright on the source code, so please don't
  97. delete his name from the program files or from the documentation.
  98.  
  99.  
  100. SUPPORT
  101. =======
  102.  
  103. I work very hard to produce a software package of the highest quality
  104. and functionality.  I try to look into all reported bugs, and will
  105. generally fix reported problems within a few days.
  106.  
  107. IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST
  108. PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
  109. ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY
  110. CLAIM BY ANY OTHER PARTY.
  111.  
  112. If you have any questions, bugs, or suggestions, please contact either
  113. of us at:
  114.  
  115.                            The Tool Shop BBS
  116.                        (602) 264-3969 (HST 9600)
  117.                        (602) 279-2673 (HAYES 9600)
  118.  
  119. The latest version is always available for downloading.
  120.  
  121. Enjoy!     Samuel H. Smith
  122.            - Author and Sysop of The Tool Shop.
  123.            Darin Wayrynen
  124.            - Author of NextGen Term, Gemspeed, and Bytefree.
  125.